home *** CD-ROM | disk | FTP | other *** search
/ The Games Machine 95 / XENIATGM95.iso / Shareware / Voodoo Movie 2.1 / README.TXT next >
Text File  |  2000-07-26  |  20KB  |  459 lines
  1.                      -= VooDooMovie V2.1 =-
  2.                  (c)1999-2000  Tjalling Hattink
  3.                 --------------------------------
  4.                  http://vdmovie.operation3d.com
  5.  
  6. 1) Introduction
  7.  
  8. This program is an addon for microsofts direct show (formerly known as
  9. active movie). It replaces the original video renderer. The video
  10. renderer is a part of the direct show system and is responsible of
  11. showing the frames of a movie on the screen in a window. When
  12. VooDooMovie is enabled it will do the job instead. It shows the frames
  13. stretched fullscreen on your 3d card. The software doesn't have to
  14. stretch the frames anymore and the 3d card uses the bilinear filtering
  15. to make the movie look better. If you have a tv output you can even show
  16. the video on the tv. Because this program only replaces the video part
  17. the rest will be processed by the default parts. You can still use the
  18. standard microsoft media player or active movie player to play your
  19. movies.
  20.  
  21. This program is SHAREWARE. You will see a text coming up slowly when
  22. you play a movie. If you register this text will be removed. You are
  23. required to register after 14 days. At the end of this readme you
  24. can read how to register.
  25.  
  26. 2) Requirements
  27.  
  28. To use this program you need at least windows98 and directx 6.0 or
  29. higher. You can also use glide 3.x instead of directx. The glide
  30. implementation also works under windows NT. You should have installed
  31. media player 6.0 or higher and able to play movies with it. This player
  32. can be found in the windows98 install. You also need a 2d or 3d card
  33. that supports glide 3.x or directx 6.0 or higher.
  34.  
  35. To use the other utils you also need mfc 4.2 or later but I assume it's
  36. always installed.
  37.  
  38. I higly discourage the use of media player 7.0 with VooDooMovie.
  39. Although it does work now there are still many bugs present. It is
  40. possible that shortcut keys don't work and it seems that for .asf or
  41. online multimedia streams VooDooMovie isn't even called (thus playing
  42. in a regular window). So please stick to media player 6.4. If you've
  43. installed media player 7.0 you can still use media player 6.4 also. It
  44. should be present as mplayer2.exe in the same dir where wmplayer.exe
  45. (media player 7.0) is present.
  46.  
  47. 3) Installing
  48.  
  49. Note: Before installing be sure to uninstall any previous version.
  50. Otherwise you could get a mix up of the renderers.
  51.  
  52. To install this program just run setup.exe. It will prompt for a
  53. directory to install to and a menugroup for the links. Then it
  54. will install all the files and enables VooDooMovie. There should be 5
  55. links in your start menu. You can uninstall the program using the
  56. uninstaller in the control panel or using the uninstall link in the
  57. start menu directly.
  58.  
  59. To see as much colors as possible during playback set your gamma
  60. settings on 1. Otherwise you have less colors and the movie will
  61. look blocky.
  62.  
  63. 4) How to use
  64.  
  65. There are 5 links in the start menu:
  66. - Properties VooDooMovie : Here you can enter various settings for
  67. the renderer. See below for more info.
  68. - Readme : Link to this readme
  69. - Disable VooDooMovie : This option disables (not uninstall) the
  70. renderer and the default window renderer will be used.
  71. - Enable VooDooMovie : This option enables voodoomovie again.
  72. - Uninstall VooDooMovie : This uninstalls the renderer and
  73. the normal window renderer will always be used again.
  74.  
  75. When you start a movie and the renderer is enabled the 3d mode will be
  76. turned on directly. If you play the movie on the monitor you can't
  77. see the player anymore. To disable the 3d mode use the exit option of
  78. the 3d menu (this menu is explained later). The default 2d display comes
  79. back and you can access the player buttons. To enable the 3d screen
  80. again search for the VooDooMovie window in your taskbar and make it
  81. active. The 3d screen should return showing the playing movie.
  82.  
  83. You can also exit to the 2D display using the CTRl + SHIFT + A
  84. keycombination.
  85.  
  86. For 3d only card a special setting is useful called Minimize Playwindow.
  87. This setting is explained later in this readme. 
  88.  
  89. When the player isn't visible you can't use the scrollbar or buttons
  90. on it to navigate through the movie. Luckily most players react on
  91. shortcut keys also. The player should be active when you use the keys.
  92.  
  93. I'll give the shortcuts of the 3 most used players:
  94.  
  95. [MEDIA PLAYER 7.0]
  96.  
  97. CTRL + P                Play or pause an open media file.
  98. CTRL + S                Stop the player.
  99. CTRL + B                Open the previous media file you played in this
  100.                         session.
  101. CTRL + F                Open the next media file in the list of files
  102.                         played in this session.
  103. CTRL + H                Shuffle the playlist.
  104. F10                     Turn volume up.
  105. F9                      Turn volume down.
  106. F8                      Turn sound off or on.
  107. ALT-F4                  Close program.
  108.  
  109.  
  110. [MEDIA PLAYER 6.x (installed by default in windows98)]
  111.  
  112. SPACEBAR                Play or pause an open media file.
  113. PERIOD                  Stop the player.
  114. PAGE UP                 Restart current clip or play previous clip
  115.                         (Skip Back).
  116. PAGE DOWN               Play next clip in playlist (Skip Forward).
  117. LEFT ARROW              Momentary rewind. Rewind stops when you release
  118.                         the key. (Doesn't always work)
  119. CTRL + LEFT ARROW       Continual rewind. Rewind continues until you
  120.                         select another control. (Doesn't always work)
  121. RIGHT ARROW             Momentary fast forward. Fast forwarding stops
  122.                         when you release the key. (Doesn't always work)
  123. CTRL + RIGHT ARROW      Continual fast forward. Fast forwarding
  124.                         continues until you select another control.
  125.                         (Doesn't always work)
  126. ALT + LEFT ARROW        Open the previous media file you played in this
  127.                         session.
  128. ALT + RIGHT ARROW       Open the next media file in the list of files
  129.                         played in this session.
  130. M or CTRL+M             Turn sound off or on.
  131. UP ARROW                Turn volume up.
  132. DOWN ARROW              Turn volume down.
  133. ALT-F4                  Close program.
  134.  
  135.  
  136. [Active movie player]
  137.  
  138. CTRL+LEFT ARROW         Rewind.
  139. CTRL+P                  Pause.
  140. CTRL+R                  Run/Start.
  141. CTRL+RIGHT ARROW        Forward.
  142. CTRL+S                  Stop.
  143. CTRL+SHIFT+LEFT ARROW   Previous.
  144. CTRL+SHIFT+RIGHT ARROW  Next.
  145. ALT-F4                  Close program.
  146.  
  147. Note: If you open a movie and nothing happens (only blank screen)
  148. press SPACE or CTRL+P (or CTRL+R for active movie player) to start
  149. playing.
  150.  
  151. The 3D Menu:
  152.  
  153. When VooDooMovie is showing the movie in 3d mode and you haven't
  154. selected The minimize playwindow option you can access the 3d menu. To
  155. open the menu press and hold the right mouse button. The following
  156. buttons appear:
  157.  
  158. +---------------+---------------+---------------+
  159. |    Zoom in    |    Zoom out   |     Move      |
  160. +---------------+---------------+---------------+
  161. | Zoom selected |   Reset zoom  |     Exit      |
  162. +---------------+---------------+---------------+
  163.  
  164. To select one of the option move the mouse pointer to the button and
  165. release the right mouse button. When you move the mouse pointer outside
  166. the buttons and you release the right mouse button no new option will be
  167. selected.
  168.  
  169. The 3D Menu options:
  170.  
  171. [Zoom in]
  172.  
  173. The mouse pointer changes to zoom in mode. When you press the left
  174. mouse button the video will zoom in with the mouse pointer as center.
  175.  
  176. [Zoom out]
  177.  
  178. The mouse pointer changes to zoom out mode. When you press the left
  179. mouse button the video will zoom out with the mouse pointer as center.
  180.  
  181. [Move]
  182.  
  183. The mouse pointer changes to move mode. When you press the left mouse
  184. button you can drag the video to another location by moving the mouse.
  185.  
  186. [Zoom selected] (Initial mode)
  187.  
  188. The mouse pointer changes to select mode. You can select an area when
  189. you keep your left mouse button pressed. After releasing the left mouse
  190. button again the selected area of the video will be shown fullscreen.
  191.  
  192. [Reset zoom]
  193.  
  194. The initial zoom and location settings of the video are used again.
  195.  
  196. [Exit]
  197.  
  198. The 3D screen is closed and the 2D display with its desktop is showed
  199. again. Now you can access the player controls. To switch back to 3D
  200. mode select the VooDooMovie window. You can also exit to the 2D display
  201. using the CTRl + SHIFT + A keycombination.
  202.  
  203. The Properties:
  204.  
  205. [3D Device Selection]
  206.  
  207. In this section you can select the device you want to use for 3d
  208. rendering. All possible renderers should be listed here. If it says
  209. "No devices found. Is DirectX 6 or Glide 3 installed?" your operating
  210. system (Like Windows NT) doesn't support DirectX 6 and/or Glide 3.x or
  211. it isn't installed yet.
  212.  
  213. Everytime you select a new device the Video Modes box and Texture color
  214. depth boxes are updated to reflect the available modes for that 3d
  215. device. 
  216.  
  217. NOTE: It is possible that devices are listed that don't support 3d
  218. acceleration. If you select one of these VooDooMovie will fail to start.
  219. Be sure that the selected device supports 3d acceleration.
  220.  
  221. [Video Properties]
  222.  
  223. In this section you can select with resolution and color depth you
  224. want to use for 3d rendering. The list of resolutions is updated each
  225. time you select a new 3d device. It is possible the some resolutions
  226. won't work. This usually means the the videocard doesn't have enough
  227. video memory to show the resolution (especially when tripple buffering
  228. is turned on. This mode needs mode video memory) or the 32 bit video
  229. mode isn't supported for 3d acceleration.
  230.  
  231. The minimize playwindow option can be selected when the 3d card isn't
  232. a 2d card (voodoo, voodoo2). When deselected a window is created for
  233. directx to render in but 3d only cards don't use this window. When you
  234. have your monitor connected to your 2d card and for example a TV on your
  235. 3d card you'll see a window covering up your whole 2d display. When
  236. you select the minimize playwindow option this window will be removed
  237. and you can access the player while playing. If your 3d card is a 2d
  238. card also don't use this option. It will only cause graphic artifacts
  239. in your render window.
  240.  
  241. You can also set the brightness of the movie. This is basically the
  242. alpha value of the 'movietextures'. The default mode is full (255).
  243. When you move the slider to the left the picture will be darker. At
  244. the most left the value is 0 and you have no picture at all.
  245. Experiment with this mode to get the best picture on your screen/tv.
  246. Especially full brightness is sometimes too white on tv's. Brightness
  247. has nothing to do with the gamma of your card. You can use gamma also
  248. to make the picture darker but gamma doesn't always work and isn't so
  249. nice in darkening as brightness is (try it out yourself). Keep your
  250. gamma on 1 and experiment with this mode instead.
  251.  
  252. [Texture Color Depth Modes]
  253.  
  254. In the Color Modes section you can enable of disable various bit modes:
  255. 8 Bit: the renderer uses a palette of 256 colors and the quality is not
  256. so good. But some videos can only play in this mode. However, try this
  257. mode when you play videos on the tv and you have a slow processor. It's
  258. quite fast and you don't see that much difference with the 16 Bit mode
  259. on the tv. Try it!
  260.  
  261. If a checkbox is gray colored it means that the current direct3d device
  262. doesn't support this texture mode.
  263.  
  264. 16 Bit 555: The renderer uses 5 bits for Red, Green and Blue. It's
  265. almost the same as 565
  266.  
  267. 16 Bit 565: The renderer uses 5 bits for Red and Blue and 6 bits for
  268. Green. This mode gives the best quality for 16 bits and doesn't take
  269. too much cpu time.
  270.  
  271. 24 Bit Palette: The renderer uses 8 bits for Red, Green and Blue and is
  272. the best quality possible for 16 bit 3d cards (3dfx). Only this mode
  273. takes much more cpu time because I have to upload very small textures.
  274. The uploaded textures are actually 8 bit with a 24 bit palette. The
  275. palette describes the colors of each pixel.
  276.  
  277. 24 Bit: The renderer uses 8 bits for Red, Green and Blue and is the best
  278. quality possible for 32 bit 3d cards (G400, TNT2).
  279.  
  280. Default are the 8 and 16 bit modes enabled and 24 bit mode disabled.
  281. Usually you don't have to change any settings, if you have a very fast
  282. computer you can try the 24 bits mode.
  283.  
  284. The renderer always tries to use the best bit mode available. That
  285. depends on what you enabled and what bit modes the movie supports.
  286.  
  287. [Movie Properties]
  288.  
  289. In the Movie Settings section you can enable and disable keep aspect
  290. ratio. When disabled the movie will always be stretched to full screen
  291. without keeping aspect ratio (the length of new size / the height of
  292. new size isn't the same as the length of original size / the height
  293. of the original size). When enabled the aspect ratio will be held
  294. and the movie won't be completely stretched to full screen. Default
  295. setting is enabled.
  296.  
  297. The bilinear setting is for enabling and disabling bilinear filtering
  298. during rendering. This setting is enabled by default. When turned on
  299. the stretched pixels (normally little blocks) will be shaded so the
  300. picture looks more blurry and less blocky. When turned off the 3d
  301. card will only stretch. When turned off the renderer will be slightly
  302. faster. When the 3d card supports anisotrophic filtering this mode will
  303. be used instead of bilinear filtering.
  304.  
  305. The tripple buffer setting is for enabling and disabling tripple
  306. buffer mode. This setting is disabled by default. When enabled the
  307. renderer might be slightly faster and smoother and 'tearing' during
  308. the movie will be eliminated. But this mode takes more video memory so
  309. on cards with only a few megs 800x600 or lower resolutions won't work
  310. anymore.
  311.  
  312. The size for 16x9 screen is used in conjunction with the keep aspect
  313. ratio option. The setting is disabled by default. When turned on the
  314. 3d output is scaled in such a way that it should be correctly sized for
  315. a 16x9 screen or tv (anamorphic resizing).
  316.  
  317. The scale slider is for scaling the movie. Default setting is 1 (no
  318. scaling). When slide to left the movie will be smaller. When the
  319. slider is completely on the left you can't see anything at all.
  320. When sliding to the left you'll zoom in on the movie (to the centre).
  321. You can zoom in to max 4 times. You can't move around in the picture
  322. but that will be supported in the future (when I make my own player).
  323.  
  324. [Control]
  325.  
  326. In here you can disable and enable VooDooMovie. When you disable it
  327. the 3d renderer will be deactivated and the default window renderer will
  328. be used. When you enable it the 3d renderer is used to play back movies.
  329.  
  330. The run on startup option can be selected to make the property page run
  331. the next time you start windows. It will be automatically hidden into
  332. the tray icon after windows has started. The default is off.
  333.  
  334.  
  335.  
  336. To apply all those settings push the Apply button. The next time
  337. VooDooMovie runs these settings will be used. To hide the property
  338. page into the tray icon push the Hide button. To completely exit the
  339. program press the Exit button.
  340.  
  341. The tray icon shows the state of VooDooMovie. When a red cross is shown
  342. VooDooMovie is disabled, otherwise its enabled. You can disable or
  343. enable VooDooMovie by left-clicking on the icon once. When you
  344. right-click on the icon a small popup menu is shown. You can choose to
  345. Enable or Disable VooDooMovie, to show the property page again, to turn
  346. on or off the keep aspect ratio option or to completely exit the
  347. program.
  348.  
  349. 5) Bugs and future plans
  350.  
  351. - The 24 Bit Palettized mode doesn't work properly on the G400.
  352. - The properties page becomes corrupt after closing a playing movie.
  353.  
  354. This program is tested on Miro hischore3d2 (voodoo 2), Miro hischore3d 
  355. (voodoo 1), Matrox G200 and Matrox G400. If you can confirm that this
  356. program works (or not) on a different video card mail me.
  357.  
  358. Please let me know if it doesn't work on your card or if you find
  359. another bug. You can mail me at tjalling@3dnews.net. If you send in
  360. please tell which version of this program you use and what kind of
  361. hardware and software (windows2000/98/95/nt) you use.
  362.  
  363. Currently I use the standard player but I'll develop my own player that
  364. is also visible on the 3d screen.
  365.  
  366. I'm working on speeding up the playback of divx movies. This is quite
  367. tricky but I have some ideas how to get this faster.
  368.  
  369. 6) Registering
  370.  
  371. This software is shareware. You may evaluate it for 14 days.
  372. After that you are required to register. The registration fee
  373. is $15 or 25 DFL. To register use the homepage. There you can pay
  374. online with your credit card. For futher instructions go to the
  375. purchase section. The homepage url is http://vdmovie.operation3d.com
  376.  
  377. If I receive enough support I'll keep developing on this program. If
  378. you have any suggestions or bugs please mail me on tjalling@3dnews.net.
  379. I need it to make this program better.
  380.  
  381. It's allowed to spread this program only when there's no fee charged
  382. for it (except for media costs) and no files are changed in this
  383. package.
  384.  
  385. For dutch people you can also register by transferring money via the
  386. bank or giro. Mail me for details.
  387.  
  388. 7) Updates
  389.  
  390. I hope to update this program with extra functionality and ofcourse
  391. bugfixes. To obtain the latest version check out 
  392. http://vdmovie.operation3d.com
  393.  
  394. where I'll always release the latest version.
  395.  
  396. 8) Troubleshooting
  397.  
  398. Sometimes you get a fatal error when starting a movie. Just try again,
  399. usually it works. I don't know where this error comes from so it's
  400. very hard to fix. Because a 2nd try almost always work I'm not going
  401. to fix it in the near future.
  402.  
  403. For more information check out the homepage.
  404.  
  405. 9) Disclaimer
  406.  
  407. The usage of this program is at your own risk! I assume no liability,
  408. whatsoever. Although this program has been extensively tested, you
  409. are adviced that random problems might occur. I'm in no way
  410. responsible for any damage caused by this program to the system or
  411. in any other way.
  412.  
  413. 10) History
  414.  
  415. V2.1  - Fixed some aspect issues for mpg movies. Now avi and mpg files
  416.         should be sized correctly. Fixed some issues with Media player
  417.         7.0. Option added to size for 16x9 screens. Property page places
  418.         a trayicon, which can be used to quickly activate and
  419.         deactivate VooDooMovie.
  420.  
  421. V2.01 - Added glide support again. It isn't tested on voodoo3 and
  422.         banshee cards so this release is for registered users only.
  423.         
  424.         Fixed a bug for G400 that causes the 3d screen staying blank
  425.         when TV out was turned on.
  426.  
  427.         Fixed various bugs in the property page that causes invalid
  428.         resolution and colordepth modes to be reported.
  429.  
  430.         Fixed verious anomalies in the renderer that could cause
  431.         crashes.
  432.  
  433. V2.0  - Rewrote the whole program. It now uses the DirectX 6.0 engine.
  434.         Added the 3D Menu with zoom options.
  435.  
  436. V1.4  - Replaced the player visible option by toggle 2D/3D with
  437.         CTRL-SHIFT-A setting, which is much easier to use. VDM should 
  438.         also work on the banshee and voodoo3 by now.
  439.  
  440. V1.3  - Add option to make player visible (by disabling the 3dfx card)
  441.         when the player window is active. Some bugfixes.
  442.  
  443. V1.2  - Changed name to VooDooMovie. No futher bugfixes needed.
  444.  
  445. V1.2B - Fixed misaligning (diagonal picture) bug for some movies.
  446.         Improved the 24 bit mode a little bit.
  447.  
  448. V1.1  - Added 24 bits mode but is quite slow. Voodoo2 bug hopefully
  449.         fixed.
  450.  
  451. V1.0  - First version. Only supported 640x480 60 Hz fullscreen with
  452.         8 and 16 bit colormodes. It was only tested on pure3d and
  453.         flash3d. It doesn't work good on voodoo2 cards.
  454.  
  455. -----------------------------------------------------------------------
  456.  
  457. Thanks for using this program and have fun with it!
  458.  
  459. Tjalling Hattink